Installing IBM Rational Test Workbench
©
Copyright International Business Machines Corporation 2001, 2012. US Government
Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp.
Table of Contents
Installation
conventions and terminology
Offering
coexistence considerations
Installing
with your Eclipse instance
Setting
repository preferences in Installation Manager
Installing
Rational Test Workbench on Windows or Linux
Starting
installation from the setup disk
Processor
value unit (PVU) licensing
Viewing
license information for installed packages
Contacting IBM Software Support
The information in this file applies to IBM® Rational® Test Workbench.
Rational Test Workbench delivers end-to-end functional, regression, load, and integration testing to address the quality challenges of highly complex and integrated applications. This offering includes the following installable components:
Note: This media pack includes version 8.2 of Rational Performance Tester and Rational Functional Tester. During the install process you will be asked to apply the latest update, version 8.2.1.4 for Rational Performance Tester and version 8.2.2 for Rational Functional Tester, to enable the functionality delivered in this release.
Important: If you are installing Rational Test Workbench on the same computer as an existing version of Rational Functional Tester or Rational Performance Tester, you must uninstall the current versions of Rational Functional Tester and Rational Performance Tester before beginning the Rational Test Workbench install.
This document provides the basic information for installing this offering. For detailed information about installing each component of this offering, refer to the product documentation:
Understanding these terms and conventions can help you take full advantage of the installation information and this product.
The following conventions are used in ths installation informatoin:
These terms are used in this documentation.
The location of product artifacts after the package is installed.
An installable unit of a software product. Software product packages are separately installable units that can operate independently from other packages in the product.
A package group is a directory in which different product packages share resources with other packages in the same group. When you install a package using IBM Installation Manager, you can create a new package group or install the packages into an existing package group. Eclipse-based packages installed in the same package group are able to use the shell-sharing features of Eclipse. Some packages cannot share a package group, in which case the option to use an existing package group is unavailable.
A storage area for installable software packages. A repository can be disk media, a folder on a local hard disk, or a server or web location.
In some instances, product packages can share resources. These resources are located in a directory that the packages share.
Installation Manager is a program for installing, updating, and modifying packages. It helps you to manage the IBM applications, or packages, that it installs on your computer. Installation Manager also helps you to keep track of what you have installed, determine what is available for you to install, and to organize installation directories.
Installation Manager provides features that help you keep packages up to date, modify packages, manage the licenses for your packages, and uninstall packages.
Installation Manager includes six wizards that make it easy to maintain packages:
Installation Manager retrieves product packages from specified repositories and installs the products into selected locations, which are referred to as package groups.
During installation, you specify a package group into which to install a product.
The shared resources directory is where product resources are installed so that they can be used by multiple product package groups. You define the shared resources directory the first time that you install the first product package. For best results, use your largest disk drive for shared resources directories. You cannot change the directory location unless you uninstall all product packages.
Important: When installing products on the Windows Vista operating system, do not create the shared resources directory in the Program Files directory (C:\Program Files\). Otherwise, users without Administrator privileges will be unable to use the product.
Some products are designed to coexist and share functions when they are installed in the same package group. A package group is a location where you can install one or more software product packages.
When you install each product package, you select whether to install the product package into an existing package group or to create a package group. Installation Manager prevents you from installing products into package groups products that are not designed to share or do not meet version compatibility and other requirements. To install more than one product at a time, the products must be able to share a package group.
Any number of eligible products can be installed to a package group. When a product is installed, the product functions are shared with all the other products in the package group. If you install a development product and a testing product into one package group, when you start either of the products, you have both the development and testing functions available to you in your user interface. If you add a product with modeling tools, all the products in the package group have the development, testing, and modeling functions available.
Note: This only applies to Rational Performance Tester and Rational Functional Tester.
The product package that you install using Installation Manager comes with a version of Eclipse, which is the base platform of this product package. If you already have Eclipse installed on your workstation, you can add your product package directly to that Eclipse installation and extend the functions of the Eclipse integrated development environment (IDE).
Extending an Eclipse IDE adds the functions of the newly installed product, but maintains your IDE preferences and settings. Previously installed plug-ins are also still available.
In most cases, your current Eclipse IDE must be the same version as the Eclipse that the product you are installing uses. Installation Manager checks that the Eclipse instance that you specify meets the requirements for the installation package and helps you install the latest updates from eclipse.org, if required.
Important: When you install products on the Windows Vista operating system, do not install Eclipse in the Program Files directory (C:\Program Files\). Otherwise, users without Administrator privileges are unable to use the product.
Installation Manager retrieves product packages from specified repository locations.
If the launchpad is used to start Installation Manager, the repository information is passed to Installation Manager. If the Installation Manager is started directly, you must specify an installation repository that contains the product packages that you want to install.
Some organizations bundle and host their own product packages on their intranet. Your system administrators will need to provide you with the correct URL.
By default, Installation Manager uses an embedded URL in each Rational software delivery product to connect to a repository server over the Internet. Installation Manager then searches for the product packages as well as new features.
When you start the installation of Rational Test Workbench from the launchpad program, the location of the repository that contains the product package you are installing is automatically defined in Installation Manager when it starts. However, if you start Installation Manager directly (for example, installing IBM Rational Test Workbench from a repository located on a web server) then you must specify the repository preference (the URL for the directory that contains the product package) in Installation Manager before you can install the product package.
Specify these repository locations on the Repositories page of the Preferences window. By default, Installation Manager uses an embedded URL in each Rational software development product to connect to a repository server through the Internet and search for installable packages and new features. Your organization might require you to redirect the repository to use intranet sites.
Note: If you are installing from a remote server, before starting the installation process, be sure to obtain the installation package repository URL from your administrator.
To specify repositories in Installation Manager:
The Setup disk includes the launchpad program, which provides you with a single location to start the installation process.
Use the launchpad program to start the installation of software in these cases:
For products that are installed by Installation Manager for the Rational Software Delivery Platform, starting the installation process from the launchpad program causes Installation Manager to be automatically installed if it is not already on your computer. Furthermore, the installation process is already configured with the location of the repository that contains the installation package. If you install Installation Manager separately, you must configure the repository preferences manually. Also, you can start the installation of a number of supporting software items from the launchpad.
To install the product, start the launchpad program.
Depending on the source of the product installation, follow one of these procedures to start the launchpad program.
If you are installing from the CDs, complete these steps:
· On Windows, run the launchpad.exe command, which is located in the root directory of the CD.
· On Linux, run the launchpad.sh, which is located in the root directory of the CD.
If you are installing from electronic disks that you downloaded from IBM Passport Advantage®, open a command line, and change to the directory where you extracted the disk images; and then at the command prompt, complete one of these steps:
Note: You must have Administrator privileges to perform this installation.
Depending on the source of your product installation, complete one of these procedures to install the product.
If you are installing from the CDs, follow these steps:
· On Windows, enter InstallerImage_win32\install.exe.
· On Linux, enter InstallerImage_linux/userinst.
If you are installing from electronic disks that you downloaded from Passport Advantage, open a command line, and change to the directory where you extracted the disk images; then complete one of these steps:
When the install program starts, Installation Manager is installed if it is not already on your computer. Furthermore, Installation Manager is configured with the location of the repository (installation files) for IBM Rational Test Workbench.
By starting the installation process from the launchpad program, Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the location of the repository that contains the product package. If you install and start Installation Manager directly, then you must set repository preferences manually.
To learn how to install the product from a command
prompt in silent mode, see the Installing Silently section of the
To install the product from the launchpad:
· On Windows, run the launchpad.exe command, which is located in the root directory of the Setup disk installation image.
· On Linux, run the launchpad.sh command, which is located in the root directory of the Setup disk installation image.
· IBM Rational Integration Tester
· IBM Rational Performance Tester
· IBM Rational Functional Tester
· IBM Rational Integration Tester Platform Pack
· IBM Rational Test Control Panel
If you
select IBM Rational Performance Tester or IBM Rational Functional Tester, you
must install these two product packages in a separate install pass,
either before or after you install any of the other product packages (which can
be installed together, just not with Rational Performance Tester or Rational
Functional Tester). Before installing
either Rational Performance Tester or Rational Functional Tester, search for
updates to the product packages by clicking Check for Other Versions, Fixes,
and Extensions and install the latest version of each of these
products. You must install the Rational Functional Tester version 8.2.2.
or later and install the Rational Performance Tester version 8.2.1.4 or later
to enable the intended functionality delivered in this release.
If you do not have Internet access,
or a local repository with the latest Rational Performance Tester and Rational
Functional Tester updates, either defer the installation of these product
packages until you do have access, or alternatively you can install version 8.2
of these product packages now, and then when you later have access to updates,
use the Update function of Installation Manager to upgrade them to the latest
version.
Note: You might see the error, "Packages IBM Rational Functional Tester 8.2.0 and IBM Rational Integration Tester 8.0.0.0 cannot coexist in the same package group." To resolve this error, you must install Rational Functional Tester version 8.2.2 or later.
· To view all updates that are found for the available packages, click Show all versions.
· To display a package description in the Details pane, click the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package that you are installing, review all information.
Note: For Installation Manager to search the predefined IBM update repository locations for the installed packages, the Search the linked repositories during installation and updates preference on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required. A progress indicator shows that the search is taking place. You can install updates at the same time that you install the base product package.
If you have purchased an Authorized User license with Rational Test Workbench, you receive these four license activation kits:
· Rational Performance Tester PVU
The Rational Performance Tester PVU license activation kit enables you to import the Rational Performance Tester PVU license activation kit so that you can leverage all the capabilities of Rational Performance Tester agents that are associated with the Rational Performance Test Server and Rational Test Virtualization Server offerings, including the ability to run virtual users on those agents without Virtual Tester pack licenses. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements. Click Next to continue.
10. On the Features page, select the package features to install.
a. Optional: To see the dependency relationships between features, select Show Dependencies.
b. Optional: Click a feature to view its brief description under Details.
c. Select or clear features in the packages. Installation Manager automatically enforces any dependencies with other features and displays updated download sizes and disk space requirements for the installation.
d. When you are installing Rational Performance Tester, select the IBM Rational Test Workbench Processor Value Unit (PVU) support checkbox so that after the installation completes, you can use the Manage License function of Installation Manager to import the Rational Performance Tester PVU license activation kit. This enables you to leverage all the capabilities of Rational Performance Tester agents. If you do not select this feature during the installation, you can use the Modify Packages function of Installation Manager to select it after the installation completes.
e. When you are finished selecting features, click Next to continue.
11. On the
common licensing configuration page, if you are using Floating or Token
licenses, type the TCP/IP port number and host name of the license servers to
use to configure licensing on the workbench computer. Separate the port number
and host name with the at sign (@). Separate the port-host pairs with
semicolons (;). To use the default port, omit the port number. If you do not
know the port numbers and names of license servers to use, you can configure
the license servers after installation by using Rational License Key
Administrator. For example, to configure three license servers that are named
license1, license2, and license3 to use port 27000, the default port, and port
1765 respectively, enter this text: 27000@license1;@license2;1765@license3
Note: If you are using
Authorized User licensing, you do not need to configure your license.
12. On the Summary page, review your choices before installing the product package. To change the choices that you made on previous pages, click Back, and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation that is completed.
13. When the installation process is complete, a message confirms the completion of the process.
14. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
15. Click Finish to start the selected package. The Install Package wizard closes and you are returned to the launchpad program.
16. License the product.
Using the Manage Licenses wizard, you can apply a license to a product or upgrade trial versions of an offering to a licensed version by importing a product activation kit. You can also enable floating license enforcement for offerings with trial or permanent licenses to use floating license keys from a license server.
For more information about managing licenses for your
Rational product, see these resources:
As a purchaser of an IBM Rational software product, you can choose from four types of product licenses:
The best choice for your organization depends upon how many people use the product, how often they require access, and how you prefer to purchase software.
An IBM Rational Authorized User license authorizes an individual to use a Rational software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.
For example, if you purchase one Authorized User license, you can assign that license to one individual who can use the Rational software product exclusively. The Authorized User license does not authorize a second individual to use that product at any time, even if the licensed individual is not using the product.
An IBM Rational Floating license is a license for a single software product that can be shared among multiple team members; however, the total number of concurrent users cannot exceed the number of floating licenses you purchase. For example, if you purchase one floating license for a Rational software product, then any user in your organization can use the product at any given time. Another person who wants to access the product must wait until the current user logs off.
To use floating licenses, you must obtain floating license keys and install them on a Rational License Server. The server responds to user requests for access to the license keys; the server grants access to the number of concurrent users that equals the number of licenses the organization purchased.
The token-based license model means that you can buy a certain number of token licenses. If you use a Rational tool that checks out a feature that is token-based, the feature line in the license file specifies the number of tokens that are checked out. Token-based licenses can only be used with floating licenses. They cannot be used for authorized user license. For more details about token licensing, contact your local IBM marketing representative.
Processor value unit (PVU) licensing provides the means for IBM to introduce pricing structures that are responsive to both the type and number of processors available to installed products.
Entitlements can be full capacity or subcapacity. Under the processor value unit licensing structure, you license software based on the number of value units assigned to each processor core. For example, processor type A is assigned 80 value units and processor type B is assigned 100 value units. If you license a product to run on two type A processors, you must acquire an entitlement for 160 value units. If the product is to run on two type B processors, the required entitlement is 200 value units.
The processor value units table, which assigns a number of value units to each supported processor type, is regularly updated to provide for the introduction of new processor technologies. Agents retrieve information about the number and type of processor on the monitored computer or partition and the table is used to determine the level of license use in terms of processor value units.
For more information about managing licenses for your Rational product, see the IBM License Metric Tool page to learn about processor virtualization unit licensing at http://publib.boulder.ibm.com/infocenter/tivihelp/v53r1/index.jsp?topic=%2Fcom.ibm.lmt75.doc%2Fcom.ibm.license.mgmt.admin.doc%2Ft_importing_software_catalogs.html
If you are installing the software for the first time or want to extend a license to continue using the product, you have options on how to enable licensing for your product.
Licenses for this product are enabled in three ways:
The Product Activation Kit CD contains the permanent license key for you product. You use Installation Manager to import the activation kit to your product.
Optionally, you can obtain floating license keys, install IBM Rational License Server, and enable floating license enforcement for your product. Floating license enforcement provides these benefits:
For more information about obtaining activation kits and floating licenses, see Purchasing licenses.
You can purchase new licenses if your current product license is about to expire or to acquire additional product licenses for team members.
Back up the product activation .jar file. If you uninstall the product and then install the product again, you might need to use the product activation .jar file to license the product again.
Optionally, you can go to IBM Passport Advantage to download the activation kit for your product. After importing the activation kit, you can switch from a floating to a permanent license type if you use your computer offline for long periods.
To import the activation kit or enable floating license support for your product, use the Manage Licenses wizard in Installation Manager.
You can review license information for your installed packages, including license types and expiration dates, from Installation Manager.
To review your license information:
The package vendor, current license types, and expiration dates are displayed for each installed package.
If the self-help resources have not provided a resolution to your problem, you can contact IBM Software Support. IBM Software Support provides assistance in resolving product issues.
Prerequisites
To submit your problem to IBM Software Support, you must have an active Passport Advantage® software maintenance agreement. Passport Advantage is the IBM comprehensive software licensing and software maintenance (product upgrades and technical support) offering. You can enroll online in Passport Advantage from http://www.ibm.com/software/lotus/passportadvantage/howtoenroll.html
To submit your problem online (from the IBM website) to IBM Software Support, you must additionally:
Procedure
Option |
Description |
Severity 1 |
The problem has a critical business impact: You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. |
Severity 2 |
This problem has a significant business impact: The program is usable, but it is severely limited. |
Severity 3 |
The problem has some business impact: The program is usable, but less significant features (not critical to operations) are unavailable. |
Severity 4 |
The problem has minimal business impact: The problem causes little impact on operations or a reasonable circumvention to the problem was implemented. |
· What software versions were you running when the problem occurred?
· To determine the exact product name and version, use the option applicable to you:
o Start the IBM Installation Manager and select File > View Installed Packages. Expand a package group and select a package to see the package name and version number.
o Start your product, and click Help > About to see the offering name and version number.
· What is your operating system and version number (including any service packs or patches)?
· Do you have logs, traces, and messages that are related to the problem symptoms?
· Can you recreate the problem? If so, what steps do you perform to recreate the problem?
· Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, or other system components?
· Are you currently using a workaround for the problem? If so, be prepared to describe the workaround when you report the problem.
· Online: Go to the IBM Rational Software Support website at https://www.ibm.com/software/rational/support/ and in the Rational support task navigator, click Open Service Request. Select the electronic problem reporting tool, and open a Problem Management Record (PMR), describing the problem accurately in your own words.
o For more information about opening a service request, go to http://www.ibm.com/software/support/help.html
o You can also open an online service request using the IBM Support Assistant. For more information, see Using the IBM Support Assistant to open a service request
· By phone: For the phone number to call in your country or region, go to the IBM directory of worldwide contacts at http://www.ibm.com/planetwide/ and click the name of your country or geographic region.
· Through your IBM Representative: If you cannot access IBM Software Support online or by phone, contact your IBM Representative. If necessary, your IBM Representative can open a service request for you. You can find complete contact information for each country at http://www.ibm.com/planetwide/.
If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support website daily, so that other users who experience the same problem can benefit from the same resolution.
Related tasks:
Registering on the IBM Software Support website
Using IBM Support Assistant to open a service request
© Copyright IBM Corporation 2001, 2012.
This information was developed for products and services offered in
the
IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
SO21 2JN
Hampshire
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
Trademarks and service marks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at http://www-01.ibm.com/software/rational/howtobuy/licensing/.
Linux is a registered trademark of Linus Torvalds in the
Microsoft, Windows, and the Windows logo are trademarks of
Microsoft Corporation in the
Other company, product or service names, may be trademarks or service marks of others.